.TH LADVD 8 "July 19, 2009" ladvd
.SH NAME
ladvd \- send link layer advertisements
.SH SYNOPSIS
.BI "ladvd [ -a ]"
.BI "[ " INTERFACE " ] [ " INTERFACE " ]"
.B ...
.SH DESCRIPTION
.B ladvd
sends LLDP (Link Layer Discovery Protocol) advertisements on all available interfaces. This makes connected hosts visible on managed switches. By default it will run as a privilege-separated daemon. Additional protocols can be enabled using the -C, -E, -F and -N options. Optionally a list of interfaces which
.B ladvd
should utilize can be supplied. Please note that only physical or bond/bridge interfaces can be specified, vlan interfaces can only be auto-detected.
.SH INTERFACES
.B ladvd
detects and uses all configured (UP) physical Ethernet interfaces by default, wireless interfaces can be enabled via the -w option. Additionally
.B ladvd
will recognize bundled interfaces (bridges, bonding) and use these to transmit additional information. The result is that normally it should not be necessary to specify interfaces on the
.B ladvd
command-line. The only reason for specifying interfaces is to explicitly exclude a particular interface.
.SH OPTIONS
.IP -a
Auto-enable protocols based on received packets (also enables receive mode).
.IP -d
Dump pcap-compatible packets to stdout which can be piped to tcpdump (via "| tcpdump -r -") or redirected to a file for further analysis.
.IP -f
Run in the foreground and send logging to stderr.
.IP -h
Print usage instructions.
.IP "-m interface"
The management interface for this host. Addresses on this interface are auto-detected (IPv4 and IPv6).
.IP -n
Use addresses of the management interface specified via -m for all interfaces.
.IP -o
Run only once, useful for quick troubleshooting.
.IP -r
Receive packets, and use them for various features.
.IP -s
Be silent, don't transmit any packets.
.IP -q
Use each interface's hwaddr the generate the chassis-id TLV. Not recommended
because the chassis-id should be the same for all interfaces.
.IP -t
Use Tun/Tap interfaces.
.IP "-u user"
Switch to this user (defaults to PACKAGE_USER)
.IP -v
Increase logging verbosity.
.IP -w
Use wireless interfaces.
.IP -y
Save received peer hostname and port description in interface descriptions (requires SIOCSIFDESCR support) or Linux ifAliases. This also enables receive mode.
.IP -z
Save received peer hostname and port name in interface descriptions (requires SIOCSIFDESCR support) or Linux ifAliases. This also enables receive mode.
.IP "-c <CC>"
Specify a two-letter ISO 3166 country code (required for LLDP location support).
.IP "-l <location>"
Specify the physical location of the host.
.IP -L
Enable LLDP (Link Layer Discovery Protocol).
.IP -C
Enable CDP (Cisco Discovery Protocol).
.IP -E
Enable EDP (Extreme Discovery Protocol).
.IP -F
Enable FDP (Foundry Discovery Protocol).
.IP -N
Enable NDP (Nortel Discovery Protocol) formerly called SynOptics Network Management Protocol (SONMP).
.SH AUTHOR
Sten Spans <sten@blinkenlights.nl>
